home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / earkit / irc / amirc.doc < prev    next >
Text File  |  1997-02-25  |  76KB  |  2,451 lines
  1.  
  2.  
  3. AmIRC
  4. *****
  5.  
  6. Welcome to AmIRC, the AmigaOS IRC client.
  7.  
  8. Copyright
  9. *********
  10.  
  11. Copyright
  12. =========
  13.  
  14. AmIRC has been designed, developed and written by
  15.  
  16.          Oliver Wagner
  17.      Landsberge 5
  18.      45549 Sprockhövel
  19.      Germany
  20.      E-Mail: <owagner@vapor.com>
  21.      
  22.      ©1996-1997 Oliver Wagner
  23.      All Rights Reserved.
  24.      
  25.      This document compiled by Laurence Walton <lww@vapor.com>
  26.      ©1996-97 Oliver Wagner
  27.      All Rights Reserved
  28.      
  29.      Installer Script
  30.      ©1995-97 Robert C. Reiswig
  31.      All Rights Reserved
  32.      
  33.      No part of this archive may be redistributed except with the entire
  34.      contents of the original archive.
  35.  
  36. Registering AmIRC
  37. *****************
  38.  
  39. License
  40. =======
  41.  
  42. AmIRC 1.41 Registered Software License Agreement
  43. ----------------------------------------------
  44. AmIRC 1.41 is Copyright © 1996-97 by Oliver Wagner, All Rights
  45. Reserved.  The producer of this software will grant the Licensee a
  46. limited, non-exclusive right to use the program AmIRC 1.41 and it's
  47. associated files on a single machine. The producer will hand out a
  48. special identification file called the key file to the Licensee. This
  49. key file will enable the Licensee to fully use the AmIRC 1.41 package
  50. according to the terms of this license.  The key file is stricly for
  51. personal use by the Licensee only. Any disclosure of they key file will
  52. invalidate the license and the key file itself. The Licensee will be
  53. held liable of any damage arising out of the disclosure of the key file.
  54. The product is provided as is without warranty of any kind, either
  55. express or implied, statutory or otherwise, including without
  56. limitation any implied warranties of non-infringement, merchantability
  57. and fitness for a particular purpose. The entire risk as to use,
  58. results and performance of the product is assumed by you and should the
  59. product prove to be defective, you assume the entire cost of all
  60. necessary servicing, repair or other remediation.  In no event shall
  61. the producer of this product or it's resellers be liable for any
  62. property damage, personal injury, loss of use or other indirect,
  63. incidental or consequential damages, including without limitation, any
  64. damages for lost profits, business interruption or data which may be
  65. lost or rendered inaccurate, even if we have been advised of the
  66. possibility of such damages.  This agreement shall exclusively be
  67. governed by the laws of the Federal Republic of Germany.
  68.  
  69. Registration
  70. ============
  71.  
  72. You may use AmIRC freely for a period of up to 30 days to evaluate the
  73. package. After those 30 days, you must either register AmIRC or stop
  74. using it completely.
  75.  
  76. To register AmIRC, see the included registration utility and assorted
  77. documentation. It has all the necessary info and prices.
  78.  
  79. What is IRC, by the way?
  80. ************************
  81.  
  82. Introduction
  83. ============
  84.  
  85. IRC stands for Internet Relay Chat, written by Jarkko Oikarinen
  86. (jto@tolsun.oulu.fi).  In a nutshell, IRC consists of a network of
  87. computers (servers) that are connected to each other via the internet
  88. or a LAN, and allow users with proper client software to connect and
  89. chat with each other.  Within this network, virtual space is divided up
  90. into channels, usually with a topic of conversation, where users can
  91. talk in groups.
  92.  
  93. Terms You Might Encounter
  94. *************************
  95.  
  96. IRC Terms
  97. =========
  98.  
  99. Action
  100.          CTCP Action command, executed by a /me at the beginning of a
  101.      message.
  102.  
  103. ARCnet
  104.      Amiga Relay Chat Network. Served by several Amigas running
  105.      CLChatServer, forming a small network used by those interested in
  106.      the Amiga Family of Computers.
  107.  
  108. Ban
  109.      A channel mode set in order to prevent a user or group of users
  110.      from joining a channel.
  111.  
  112. Bot
  113.      Short for Robot, a Bot is a script that acts like a user, and
  114.      can execute a command upon a certain occurance.
  115.  
  116. Client
  117.      Software that is written for the purpose of connecting to a
  118.      server, in this case, an IRC server.
  119.  
  120. Channel
  121.      A group of users on IRC. A channel will have a name (i/e,
  122.      #AmIRC), and may or may not have a topic of conversation.
  123.  
  124. Channel Mode
  125.      The properties of a channel that allow or disallow certain
  126.      activities.  Channel Modes can only be changed or set by
  127.      Channel Operators.
  128.  
  129.     Invite Only
  130.           If active, This mode allows users to join if they have been
  131.           invited by someone in the channel.
  132.  
  133.     Private
  134.           If active, the channel is invisible in the global channel
  135.           list.
  136.  
  137.     Limit
  138.           If active, Sets a limit on the number of users allowed to
  139.           join a channel.
  140.  
  141.     Moderated
  142.           If active, only Channel Operators and users with
  143.           voice may type input to the channel.
  144.  
  145.     No Messaging
  146.           If active, prevents users from sending a message to the
  147.           channel until they have joined it.
  148.  
  149.     Secret
  150.           If active, the channel is invisible until it is joined.
  151.  
  152.     Topic Protection
  153.           If active, only Channel Operators may set or change the
  154.           topic of a channel.
  155.  
  156. Channel Operator (aka, Op)
  157.      A user who has control over a channel.  A user who creates a
  158.      channel is given Op status, and in turn can give it to anyone else
  159.      in the channel.
  160.  
  161. Chat Network
  162.      A network of computers that are interconnected so that anyone on
  163.      any server in the network may chat with anyone else on any
  164.      computer in that same network.
  165.  
  166.          some major chat networks:
  167.  
  168.     ARCnet
  169.           Amiga Relay Chat Network.  Note that this is not a real IRC
  170.           network and has its own client, but IRC clients can connect
  171.           here, with some limitations.
  172.  
  173.     EFnet
  174.           Eris Free Network.  The largest IRC network.
  175.  
  176.     DAL-Net
  177.           A different IRC network with some specialized functons that
  178.           do not appear in typical IRC networks.
  179.  
  180.     Undernet
  181.           An alternative IRC network
  182.  
  183.     Innernet
  184.           Another alternative network.
  185.  
  186. Command
  187.      A message to an IRC server or to a local or remote client.
  188.      Commands generally begin with a /.  See Commands.
  189.  
  190. CTCP
  191.      Client To Client Protocol, A standard for sending commands from
  192.      one client to another, usually for the purpose of getting
  193.      information from the remote client.  See CTCP.
  194.  
  195. DCC
  196.      Direct Client Connection - a standard for creating a direct link
  197.      between two clients, for the purpose of sending or receiving
  198.      files, or to carry a more secure conversation.  See DCC.
  199.  
  200. Efnet
  201.      (Eris Free), the largest and "main" IRC network, with an average
  202.      of about 5000 users on any given day.
  203.  
  204. Identd
  205.      Identd Is software that can be run on the client, allowing an IRC
  206.      server to corroberate the identity of a client.  AmIRC has an
  207.      Identd built in, and will automatically disable it if an external
  208.      Identd is running.
  209.  
  210. IRC
  211.      Internet Relay Chat - Any Network of Computers that run IRC
  212.      servers for the purpose of allowing users to connect to it
  213.      using client software made for IRC.
  214.  
  215. Kick
  216.      The occurance of a user being removed from a joined channel by
  217.      a channel operator.
  218.  
  219. MOTD
  220.      Message Of The Day, A message that may or may not be updated
  221.      daily, that is meant to be read when connecting to an IRC
  222.      server.
  223.  
  224. Netsplit
  225.      An event that occurs when a server goes down that other servers
  226.      depend on for network packets. Any servers that are dependant on
  227.      the crashed server will split from the net, that is, they will
  228.      still be up and running, with active clients, but any clients on
  229.      the other side of the crashed unit will appear to have all logged
  230.      off at once.
  231.  
  232. Nick
  233.      Short for Nickname, this is an alias that you may pick for
  234.      yourself.
  235.  
  236. Op
  237.      See Channel Operator.
  238.  
  239. Server
  240.      A computer that is Running IRC server software, allowing it to be
  241.      connected to by IRC clients or other servers.
  242.  
  243. Server Operator
  244.      A person in control of an IRC server.
  245.  
  246. TLA (Three Letter abreiviations)
  247.      commonly used acronyms, not entirely restricted to 3 letters.
  248.  
  249.     AFAIK
  250.           As Far As I Know
  251.  
  252.     AFK
  253.           Away From Keyboard
  254.  
  255.     BRB
  256.           (I'll) Be Right Back
  257.  
  258.     BBL
  259.           (I'll) Be Back Later
  260.  
  261.     IMHO
  262.           In My Humble|Honest Opinion
  263.  
  264.     LOL
  265.           Laughs Out Loud
  266.  
  267.     MOTD
  268.           Message Of The Day
  269.  
  270.     ROTFL
  271.           Rolls On The Floor Laughing
  272.  
  273.     RTFM
  274.           Read The F***ing Manual
  275.  
  276. Topic
  277.      A heading for a channel that may or may not have anything to do
  278.      with the conversation at hand.
  279.  
  280. Undernet
  281.      The second largest IRC network, considered an 'Alternative' to
  282.      EFnet.
  283.  
  284. User
  285.      a person using an IRC Client to connect to a server to chat.
  286.  
  287. User Mode
  288.      Settings that affect a users properties.
  289.  
  290.     Invisible
  291.           If this mode is set, a user will be invisible in the global
  292.           user list.  The user will still be visible in the user list
  293.           of any joined channel, however.
  294.  
  295.     Wallops
  296.           When set, this mode will allow receiving of messages from the
  297.           server operator to all operators.
  298.  
  299. Userhost
  300.      This is the string that defines a user.  It consists of the
  301.      user's chosen nick, login name and domain name.  For example:
  302.      Wupper!jwupper@monorail.denet234.de
  303.      |      |       |        |      |_ Domain
  304.      |      |       |        |________ Network
  305.      |      |       |_________________ Machine
  306.      |      |_________________________ Login
  307.      |________________________________ Nick
  308. Voice
  309.      Status a normal (not an operator) user must have to type into a
  310.      moderated channel.
  311.  
  312. Things that make AmIRC special!
  313. *******************************
  314.  
  315. Features
  316. ========
  317.  
  318.    * runs with both AmiTCP and AS225, and now Miami, without additional
  319.      support libraries.
  320.  
  321.    * built-in high speed DCC drivers for SEND and MOVE.  Highly
  322.      optimized with asynchronous file I/O and threaded network
  323.      handling. Supports Drag&Drop sending of files.
  324.  
  325.    * transparent implementation of DCC CHAT. All /MSGs are
  326.      automatically routed via DCC CHAT if applicable, to save runtime
  327.      and reduce IRC load. Option to automatically accept DCC CHAT
  328.      connections.
  329.  
  330.    * ultra fast text output and scrolling. Supports Cut&Paste for the
  331.      list text. Supports proportional fonts.
  332.  
  333.    * full support of the "Undernet" IRC extensions, both reply codes and
  334.      additional IRC commands.
  335.  
  336.    * intuitive channel display with userlist and channel mode overview.
  337.      Channel modes can easily be changed via gadgets. Configurable user
  338.      action list to perform whatever action you like on users in channel
  339.      by the press of a mousebutton.
  340.  
  341.    * supports QUERY windows for private chat.
  342.  
  343.    * supports "smart" banning
  344.  
  345.    * versatile AREXX port including server message parsing ("event
  346.      trapping") and commandline/script interaction.
  347.  
  348.    * easy command line aliasing.
  349.  
  350.    * builtin IdentD (automatically disabled if another IdentD is already
  351.      installed).
  352.  
  353.    * supports nick notification, highlighting, ignoring, and kickban.
  354.  
  355.    * versatile event handling allows you to bind sound effects,
  356.      auto-deiconify or rexx scripts to certain events.
  357.  
  358.    * server phonebook.
  359.  
  360.    * last nick history.  Stores the nicknames of the last nicks you've
  361.      send MSGs to, received MSGs from or addressed publically with
  362.      "nick:".  Reference can be used in all commands which require nick
  363.      names, e.g.  /MSG, /OP, /DEOP. Automatic nick expansion on public
  364.      messages with ":".
  365.  
  366.    * TAB messaging to automatically cycle the list of last used
  367.      nicknames with a /MSG prefix.
  368.  
  369.    * auto rejoin channel on KICK and auto reconnect server facility.
  370.  
  371.    * auto away after idle timeout. Auto unaway after sending public
  372.      and/or private msgs.
  373.  
  374.    * auto update download.  Check for and download new releases with a
  375.      simple click.
  376.  
  377.    * URL grabber for interfacing with a web browser..
  378.  
  379.    * Support for DALnet extensions.
  380.  
  381. What is needed to run AmIRC?
  382. ****************************
  383.  
  384. Hardware
  385. ========
  386.  
  387. AmIRC was written for the Amiga family of computers, and has been
  388. tested on 1200, 2000, 3000, & 4000 computers in various configurations.
  389.  
  390. Software
  391. ========
  392.  
  393. AmIRC requires About MUI V3.6 or later in order to run.
  394.  
  395. AmIRC requires KickStart & WorkBench 2.x or later, with setpatch 40.16
  396. installed.
  397.  
  398. AmIRC020 requires a 68020 or higher CPU, OS3.0 or newer, and MUI 3.6 or
  399. newer.  If you do not have anyone of these, you must use the 68000
  400. version of AmIRC.
  401.  
  402. If you plan to run a TCP/IP stack and AmIRC among other Internet
  403. applications you should have at least 2 megabytes of RAM.
  404.  
  405. Finally, You need to have a tcp/ip protocol stack running, such as
  406. Miami, AmiTCP/IP or Amiga Technology's as225r2 tcp/ip protocol stack,
  407. With a slip, cslip, or ppp connection to the internet or an ethernet
  408. LAN.
  409.  
  410. Alternatively, AmIRC will work with Multilink and a shell internet
  411. account.  NOTE: As Mlink does not automatically set the HOSTNAME
  412. variable, this must be done when starting mlink. Env:hostname must
  413. contain the full domain name for your amiga, i/e
  414. 'calci.amiganet.pgh.net'.
  415.  
  416. Getting AmIRC to run
  417. ********************
  418.  
  419. Requirements
  420. ============
  421.  
  422. AmIRC has its own installer script and requires that you have the Amiga
  423. installer utility (version 1.24 or later) located in your sys:c
  424. directory.  To install, just click on the install icon, and answer the
  425. questions in the installer's requestors.
  426.  
  427. If you cannot or prefer not to use the installer utility, a manual
  428. install is very simple, just move the contents of the archive to a
  429. directory of your choice and it's ready to use.  If you have met the
  430. Requirements for the optimized version of AmIRC, delete the AmIRC file
  431. and rename "AmIRC020" as "AmIRC".
  432.  
  433. Connecting to a server
  434. **********************
  435.  
  436. Setup
  437. =====
  438.  
  439. Once you have Installation AmIRC, run the AmIRC program from WB by
  440. clicking on its icon. After a few moments you will see the server
  441. connect requester appear. First type in a nickname in the first text
  442. gadget at the top of the requester.  If you intend to use a nick that
  443. may be common, try typing in some variations in the next three boxes.
  444. this way, if your nick is in use by another person, the client will
  445. retry with the next nick.
  446.  
  447. Next, enter your real name and your email address or www home page URL
  448. in the next text gadget. It is probably a good idea to be truthful
  449. here. :)
  450.  
  451. Then, enter a username that will show as
  452. «username»@machine.network.org.  «username» should be the same as the
  453. login ID for your service provider.
  454.  
  455. Now you are ready to connect.  Just click on a server from the supplied
  456. list or click new server entry and type the address and port number of
  457. your favorite server and then click connect. Optionally, you can choose
  458. one or a few channels to autojoin, just separate them with a comma.  If
  459. you are already connected, and wish to connect to a second server,
  460. click connect thread to open a second instance of AmIRC. Use the Copy
  461. Server Entry gadget to make a duplicate of the currently selected server
  462. entry.  The Delete Server Entry gadget will remove a server entry that
  463. you no longer wish to use.
  464.  
  465. How Does AmIRC Work?
  466. ********************
  467.  
  468. Using the Interface
  469. ===================
  470.  
  471. The AmIRC user interface is laid out in a logical, intuitive manner,
  472. making it easy to use.
  473.  
  474. Text Listview
  475.      The main feature of the interface is the text listview, where
  476.      incoming text is displayed.
  477.  
  478. Text Input Gadget
  479.      Directly below this is the text input gadget, labeled with the
  480.      nickname that you have chosen. Any text entered here will be sent
  481.      out to the IRC server.
  482.  
  483. Listview Scroll Gadget
  484.      To the right of the listview is a scroll gadget, which enables you
  485.      to scroll backward through the text in the listview.
  486.  
  487. Channel Text String
  488.      At the top left of the listview is a text string that reflects the
  489.      channel that you have joined.
  490.  
  491. Topic Input/Display Gadget
  492.      To the right of the channel text string, is the Topic
  493.      Input/Display gadget, where the topic of a joined channel will be
  494.      displayed.  If you have Channel Operator (Ops) Status, you may
  495.      change the topic of the channel by entering the topic in this
  496.      gadget, and hitting the 'enter' key.
  497.  
  498. Operator Buttons
  499.      To the right of the topic input gadget are the channel mode
  500.      buttons, which display the current modes for the joined channel.
  501.      Users with Channel Operator (Ops) status may also use these
  502.      buttons to change the current channel modes.
  503.  
  504.     T - Topic Protection
  505.           Toggles Topic Protecton on/off.  If on, the topic can be
  506.           changed by Channel Operators (Ops) only.
  507.  
  508.     N - No Messaging
  509.           Toggles Messaging on/off.  If active, a user can only write
  510.           to the channel if they have joined it.
  511.  
  512.     S - Secret
  513.           Toggles Secret mode on/off.  If active, the channel is
  514.           invisible until it is joined.
  515.  
  516.     I - Invite Only
  517.           Toggles Invite Only mode on/off.  If active, users can only
  518.           join after they have been invited.
  519.  
  520.     P - Private
  521.           Toggles Private mode on/off.  If active, the channel will be
  522.           invisible in the global channel list.
  523.  
  524.     M - Moderated
  525.           Toggles Moderated mode on/off.  If active, only channel
  526.           operators (Ops) and users with 'voice' can type to the
  527.           channel.
  528.  
  529.     L - Limit
  530.           Sets a limited number of users allowed on the channel
  531.  
  532.     K - Keyword
  533.           Toggles Keyword mode on/off.  If active, Users can only join
  534.           the channel if they give the correct keyword.
  535.  
  536.     B - Ban
  537.           Sets/Displays the current Bans active on the channel
  538.  
  539. User Listview
  540.      Below the channel mode buttons is the User Listview, which shows a
  541.      current list of users on the joined channel.  Double clicking on a
  542.      users name will perform a /whois on that user.  Clicking once on a
  543.      users name will set that user as the default to perform other
  544.      operations on, such as an operation from the configurable user
  545.      buttons.
  546.  
  547. User Buttons
  548.      Directly below the User Listview are the user buttons.  These
  549.      buttons are configurable from the GUI window, accessable by
  550.      selecting 'setup...' from the AmIRC Settings menu.
  551.  
  552. Special Functions:
  553.      You can Drag-Hilight text in the listview in order to paste it
  554.      elsewhere.  you will need some type of snap utility such as
  555.      newedit or powersnap in order to past the text.  The text is
  556.      stored in the clipboard.
  557.  
  558.      The TAB key will cycle through the names of people that have
  559.      previously /msg'ed you, and insert it into the text input gadget.
  560.      Simply enter your message after the "/msg <user> " in order to
  561.      /msg them back.
  562.  
  563.      Entering ":" first in the text input gadget will automatically
  564.      publicly address the last person you typed to using the ":" after
  565.      their nick.
  566.  
  567. Pull-Down Menus
  568. ***************
  569.  
  570. Reference
  571. =========
  572.  
  573. AmIRC Menu
  574. ----------
  575.  
  576. Select Server...
  577.      Opens a window from which you can select various options for
  578.      connecting to an IRC server. See Connecting.
  579.  
  580. Logging Enabled?
  581.      Toggles logging on/off.
  582.  
  583. Iconify
  584.      Reduces the AmIRC window to an icon on the Workbench screen.
  585.  
  586. Help...
  587.      Opens Amirc.guide for reference while using AmIRC.
  588.  
  589. About AmIRC...
  590.      Opens a window with information about AmIRC and its Developer.
  591.      Here you may connect to the AmIRC home page if amosaic is running
  592.      concurrently, and you may also download the latest version of
  593.      AmIRC without having to trouble with running a www or ftp client.
  594.  
  595. About MUI...
  596.      This will open a small window that displays information about the
  597.      current version of MUI that is installed on your system, also,
  598.      this window provides the option to register or update your MUI
  599.      software.
  600.  
  601. Quit
  602.      Will close the current instance of AmIRC, leaving other instances
  603.      open.
  604.  
  605. Windows Menu
  606. ------------
  607.  
  608. Channel Windows
  609.      If more than one AmIRC window is opened, You may select one here
  610.      to pop it to front.
  611.  
  612. Dialog Windows
  613.      If any dialog windows are open, you may select one here and bring
  614.      it to front.
  615.  
  616. Channel List Window...
  617.      This item will produce a requester where you may list channels by
  618.      min users or pattern matching, or both. Once listed, you may list
  619.      users on a channel or join it by double-clicking the channel name
  620.      or selecting 'join channel' gadget.  Please note that this
  621.      function can cause a high load of traffic and may take awhile on
  622.      slow (14.4 or less) connections.
  623.  
  624. Notify Window...
  625.      Selecting this item will produce a requester where you may enter
  626.      nicks of users that you wish to be notified of their
  627.      entering/leaving IRC.  The 'check period' is how often AmIRC will
  628.      check for the specified users.  Add a nick to the list by clicking
  629.      in the input text gadget, and typing in the nick.  delete a nick
  630.      by clicking on it's entry and then click on 'delete nick' gadget.
  631.  
  632. DCC-Send Window...
  633.      Brings up a requestor in which you can specify a user and a file
  634.      to send to them.  This requester will also be produced
  635.      automatically upon hitting the 'DCC send' userbutton on the
  636.      interface.  'Send Path' is the path and filespec that will be sent
  637.      to the user.  Enter the name of the user in the text input gadget
  638.      at the bottom of the requestor.  The cycle gadget nest to the nick
  639.      text gadget selects either 'DCC Send' or 'DCC Move' protocols.
  640.      See DCC for details about these protocols.  Remove Job gadget
  641.      will remove a complete send entry or if not complete, one click
  642.      will abort the send and the second click will remove the entry.
  643.  
  644. DCC-Receive Window...
  645.      Selecting this item will produce the 'Receive DCC List' requester.
  646.      This is very similar to the DCC Send Requester.  Note that this
  647.      requester will appear automatically on receiving a DCC request.
  648.      Enter a path for incoming files to be put in the 'Receive Path'
  649.      text gadget.  After a valid path is entered, click on an entry to
  650.      receive, then click the 'Get' gadget at the bottom.  If you are
  651.      trying to receive after a failed send, you may use the 'Resume'
  652.      gadget instead of get.  this will attempt to pick up the transfer
  653.      where it left off.  I you wish to rename the incoming file for
  654.      whatever reason, you may use the 'Rename' gadget to give the file
  655.      a new name.  'Remove Job' gadget will abort an incoming file and
  656.      remove a completed or aborted file. See DCC.
  657.  
  658. DCC-Chat Window...
  659.      Selecting this item will open the 'DCC Chat List' requestor.  Do
  660.      this if you receive a DCC chat request from another user..  Here
  661.      you may click on the client sending the chat request and click the
  662.      'Open' gadget to engage a DCC chat.  When finished, you can click
  663.      "Close' to close the connection.  See DCC.
  664.  
  665. Raw Log Window...
  666.      This will open the Raw Log Window, in which you can view the raw
  667.      IRC messages as they appear before AmIRC formats them for Easy
  668.      reading in the AmIRC listview.  Here you may also clear the log,
  669.      and select when the log is active: 'Never', 'Only when raw window
  670.      open', and 'Always' The log Listview shows the USERHOST, Type of
  671.      message, Channel Name, and message, in that order.
  672.  
  673. URL Grabber Window...
  674.      A New feature of AmIRC allows it to recognise WWW URLs and snap
  675.      them to a window for use with Amosaic Web Browser.  Double
  676.      clicking an entry in the URL grabber Window will automatically
  677.      send the URL to the Clipboard..
  678.  
  679. Private Messages Window...
  680.      This item will open the Private Messages Window.  This window
  681.      holds a history of private messages sent to you, where you can
  682.      later reference or review them.
  683.  
  684. Info Messages Window
  685.      this item will open a window that displays server messages, wallops
  686.      messages, and ctcp requests.  If the "Shangahi" gadgets are
  687.      activated for these messages, they will be prevented from showing
  688.      in the main channel window, even if the info window is closed.
  689.  
  690. Flush Buffer
  691.      This item will clear the history of the main AmIRC listview.
  692.  
  693. Save Buffer...
  694.      This item allows you to select a filename to save the history
  695.      buffer to disk.
  696.  
  697. User Modes Menu
  698. ---------------
  699.  
  700. Invisible?
  701.      Toggles your client between invisible or not invisible. See IRC
  702.      Terms.
  703.  
  704. Receive Wallops?
  705.      Toggles this mode on/off.  See IRC Terms.
  706.  
  707. Receive Server Notices?
  708.      Toggles this mode on/off.
  709.  
  710. Marked AWAY?
  711.      Toggles AWAY on/off.
  712.  
  713. Auto rejoin on KICK?
  714.      If set, will automatically attempt to reconnect you to a channel
  715.      you have been kicked from. Note that if a ban was set with the
  716.      kick, you will not be able to rejoin.
  717.  
  718. Auto reconnect to server?
  719.      If set, this will automatically attempt to reconnect you to the
  720.      server if you are disconnected for any reason.
  721.  
  722. Auto open Dialog Windows?
  723.      If set, will automatically open chat window upon receipt of a /msg
  724.      or dcc chat message.
  725.  
  726. Auto accept dcc chat requests?
  727.      If set, this will automatically accept a dcc chat request.  It
  728.      will not open a chat window for you, however. Do this by opening
  729.      the DCC chat window in the Windows menu.
  730.  
  731. Do BEEPS?
  732.      If set, AmIRC will send audio beeps (or samples, if configured in
  733.      the Events page of the settings requester) for certain events.
  734.  
  735. Play CTCP SOUND requests?
  736.      If checked, AmIRC will acknowledge and play /ctcp sound requests,
  737.      if this is configured properly.
  738.  
  739. Settings Menu
  740. -------------
  741.  
  742. Setup...
  743.      Calls the AmIRC Setup, allowing you to change the many settings of
  744.      AmIRC to suit your needs.
  745.  
  746. Lists...
  747.      Calls up the Lists, allowing you to configure AmIRC's Alias,
  748.      Ignore, and Hilite lists.
  749.  
  750. Function Keys...
  751.      Calls the Function Keys, allowing you to configure the function
  752.      key macros.
  753.  
  754. Dialog Window Buttons?
  755.      If set, the AmIRC dialog window will contain 4 gadgets in the
  756.      upper right corner.  These are labeled: 'Whois', 'Ping', 'DCC
  757.      Chat', & 'DCC Send'.  These gadgets will perform their respective
  758.      functions on the user that the dialog window is opened to.
  759.  
  760. Load Settings...
  761.      Opens a requestor allowing you to recall previously saved
  762.      non-default AmIRC Configurations.
  763.  
  764. Load settings from default
  765.      Reloads the last saved default configuration
  766.  
  767. Save Settings Saves the current configuration under the last name set
  768.      in the 'Save settings as...' menu item.  If the settings have not
  769.      previously been named, they are saved as default.
  770.  
  771. Save settings as...
  772.      Opens a requester allowing you to choose a filename to save the
  773.      current AmIRC configuration as other than default.
  774.  
  775. Save as default
  776.      Saves the current AmIRC configuration as the default startup
  777.      configuration.
  778.  
  779. Create icons?
  780.      If Checked, will create icons for saved configuration files,
  781.      allowing them to be seen on the Workbench.
  782.  
  783. Save Settings On Exit
  784.      if checked, this item will cause AmIRC to save the current
  785.      settings as default upon exiting AmIRC.
  786.  
  787. MUI Settings...
  788.      Opens the MUI Prefs program for altering the MUI Configurable AmIRC
  789.      configuration.
  790.  
  791. Rexx Menu
  792. ---------
  793.  
  794. This menu will Display any ARexx scripts that reside in AmIRC/Rexx/
  795. directory. AmIRC ARexx scripts should be named with the .amirx
  796. extension.  From this menu you may execute any existing AmIRC ARexx
  797. script.
  798.  
  799. Sending commands to other people
  800. ********************************
  801.  
  802. Introduction
  803. ============
  804.  
  805. CTCP or Client To Client Protocol
  806. ---------------------------------
  807.  
  808. CTCP is a standard for sending commands to other clients on IRC.
  809. Basically, CTCP messages are simply private messages that include a
  810. code to alert the receiving client (not user) to respond to the command.
  811.  
  812. CTCP commands are typicaly used to get informaton from the receiving
  813. client, such as /CTCP time, or /CTCP version. Even DCC sends a request
  814. via CTCP to the receiving client, asking to initiate a direct
  815. connection.
  816.  
  817. CTCP Commands
  818. -------------
  819.  
  820.          
  821.  
  822.    * ME (CTCP Action)
  823.               Template: /ME <action>
  824.      This will mark the message as an action and replace the /ME with
  825.      your nick, for example, '/me hates ice cream' would appear as:
  826.          [Action]  |Fred hates ice cream
  827.  
  828.          
  829.  
  830.    * Version
  831.               Template: /CTCP <user> Version
  832.      Version will ask the client to return information about itsself,
  833.      which will be in the form of a private message.
  834.  
  835.          
  836.  
  837.    * Time
  838.               Template: /CTCP <user> Time
  839.      Time will return the time of day as it is set on the user's
  840.      machine.
  841.  
  842.          
  843.  
  844.    * Ping
  845.               Template: /ping <user>
  846.      Ping will send a packet request to the receiving client, which
  847.      will in turn send back the packet with a timestamp, where the
  848.      inititating client will compare the time difference and show the
  849.      result in the listview.
  850.  
  851.          
  852.  
  853.    * Sound
  854.               Template: /CTCP <user> Sound <soundfile>
  855.      Sound will attempt to locate and play a soundfile in the directory
  856.      the receiving user has configured as the "sound" directory in
  857.      AmIRC. Some IRC clients for other platforms support this function
  858.      as well.  note that the <soundfile> must exist in the receiving
  859.      users directory or nothing will happen.  Generally, a set of
  860.      sounds are agreed upon in advance for a particular group of users.
  861.  
  862. Direct client connections
  863. *************************
  864.  
  865. What is DCC?
  866. ============
  867.  
  868. DCC or Direct Client Connection is a protocol that IRC clients can use
  869. to communicate directly with each other, bypassing the IRC server.  The
  870. reason for this is to form a faster, more stable and direct connection
  871. thru which users can transfer files, or send private messages.
  872. Note that AmIRC has its own set of Highly Optimized DCC protocols
  873. built-in, and does not require external DCC utilities.
  874.  
  875. DCC File Transfers
  876. ==================
  877.  
  878. The most common use of DCC is for transferring files between two
  879. clients.  The initiating client will send a message through the IRC
  880. server, telling the receiver that a connecton is requested.  At this
  881. time, the receiver will either accept or reject the offer for the
  882. connection.  If the receiver accepts the connection, the initiating
  883. client will proceed to send the information directly to the receiver.
  884. If the connecton is refused, the initiating client will simply timeout
  885. the attempt to connect.
  886.  
  887. DCC Send
  888. --------
  889.  
  890.     Template: /DCC send <user> <filespec>
  891.      DCC send will attempt to open a connecton with the specified user's
  892.      client, and if successful, will proceed to send the specified file.
  893.  
  894. DCC Move
  895. --------
  896.  
  897.     Template: /DCC move <user> <filespec>
  898.      DCC Move is identical to DCC Send, with the exception that DCC move
  899.      is capable of resuming an interrupted or failed transfer.  DCC Move
  900.      will look into the receiving directory for existing files, and upon
  901.      finding a partial file which is the same as the file to be transferred,
  902.      will initiate a /DCC Resume transfer.  With AmIRC, This process
  903.      is completely transparent.  If no partial or whole file exists, then
  904.      the file will be completely transferred.
  905.  
  906. DCC Get
  907. -------
  908.  
  909.     Template: /DCC get <user sending file>
  910.      DCC get is a transparent operation with AmIRC, and is only mentioned
  911.      in this document for the sake of being thorough.  AmIRC will notify
  912.      you of an incoming DCC request, and allow you the option to accept
  913.      or reject the connecton with a simple click.
  914.  
  915. DCC Chat
  916. ========
  917.  
  918. Another use of the DCC standard is DCC chat, which, like DCC Send, will
  919. send a CTCP request to the receiving client to set up a direct link.  In
  920. this case, however, the purpose of the link is for users to send
  921. messages to each other.  Because the mesages are sent through the
  922. direct link, and do not pass through the IRC server, this method of
  923. sending messages is much more private than using the IRC's privmsg
  924. (/msg).
  925. With AmiRC, it must be noted that a DCC Chat request will not open a
  926. dialog window for you, instead, when DCC chat is initiated and accepted,
  927. all privmsg's (/msg) to the receiving user will be sent through the DCC
  928. link.  If you wish to have a dialog box for chatting, the best way to go
  929. about this is to highlight the users's name in the listview by clicking
  930. on it.  then click on the 'Query' gadget below the listview.  this will
  931. open a window that has several options within it. From here, you can
  932. 'ping' or 'whois' the other user, or you may inititate a 'DCC Send' or
  933. 'DCC chat'.  Starting a 'DCC Chat' from this window will allow you to
  934. carry on a dialog with the remote user through the window.
  935.  
  936. Commands
  937. ********
  938.  
  939. Overview
  940. ========
  941.  
  942. AmIRC has several builtin commands. Some of these commands are
  943. processed locally, whereas others are sent to the IRC server.
  944.  
  945. Commands generally start with a / to differentiate them from normal
  946. text. If you want to use the / character at the start of normal text,
  947. use // instead.
  948.  
  949. Many commands require a channel name as a parameter. AmIRC will
  950. automatically fill in the channel name of the current window if you
  951. don't specify a channel name on your own.
  952.  
  953. For commands which require a nick name (e.g. /MSG or /OP, there
  954. are three special shortcut arguments:
  955.  
  956. .
  957.      The period is replaced with the nickname of the last person you
  958.      have send a private message to.
  959.  
  960. ,
  961.      The comma is replaced with the nickname of the last person who
  962.      send a message to you. Be careful with this, since you might
  963.      easily address the wrong person if someone sends you a message
  964.      while you are still typing this command!
  965.  
  966. :
  967.      The colon is replaced with the nickname of the last person which
  968.      you haved a addressed with a nick: prefix inside a channel.
  969.  
  970. You may easily carry a dialog with a particular user by first clicking
  971. on their username in the user list, then anytime you hit the tab key,
  972. the input string will be set up with '/msg <user> ', after which you
  973. may type in the message and hit return.  This will work after
  974. initiating a DCC Chat request as well.  Please note that if you have
  975. configured the user list as a separate window, you must reactivate the
  976. message window after clicking on a username.
  977.  
  978. Reference
  979. =========
  980.  
  981. AWAY
  982. ----
  983.  
  984. Usage: /AWAY [message]
  985.  
  986. When used with the optional <message> argument, /AWAY will mark you as
  987. being away and send the message to any client sending a MSG to you.
  988. otherwise, it will remove a previously set away message.
  989.  
  990. EXAMPLES:
  991.  
  992. /AWAY eating dinner
  993.      will send the message '<nick> is away: eating dinner', where nick
  994.      is the nickname of the user that is away.
  995.  
  996. /AWAY
  997.      will remove a previously set Away Message.
  998.  
  999. INVITE
  1000. ------
  1001.  
  1002. Usage: /INVITE <nickname> <channel>
  1003.  
  1004. Invites a user to the channel given in the argument, regardless of
  1005. weather the channel exists.  If the named channel is MODE, the user
  1006. performing the command must be a channel operator for that channel.
  1007.  
  1008. EXAMPLES:
  1009.  
  1010. /INVITE freddie #AmIRC
  1011.      Sends a message to 'freddie', inviting him to join #AmIRC.
  1012.  
  1013. ISON
  1014. ----
  1015.  
  1016. Usage: /ISON <nickname>{<space><nickname>}
  1017.  
  1018. Quickly returns the users nick if it is found, does nothing if it is
  1019. not.
  1020.  
  1021. EXAMPLES:
  1022.  
  1023. /ISON Kenneth
  1024.      Returns: '<ISON>Kenneth', if nick 'Kenneth' is found on the
  1025.      server.
  1026.  
  1027. JOIN
  1028. ----
  1029.  
  1030. Usage: /JOIN channel[,channel[,...]] [key[,key[,...]]]
  1031. Usage: /CHANNEL channel[,channel[,...]] [key[,key[,...]]]
  1032.  
  1033. Join a channel on the IRC.  If the channel doesn't exists, it is
  1034. automatically created.
  1035.  
  1036. There are two kinds of channels:  Channel names starting with an
  1037. # are global channels and available on all IRC servers which
  1038. are connected to the net you are currently on.  Channels which begin
  1039. with & are local to the chat server you are connected to.
  1040.  
  1041. If a channel requires a special keyword to join, you must submit this
  1042. after the channel name.
  1043.  
  1044. AmIRC will look for a channel window which isn't currently bound to a
  1045. channel. If it doesn't find one, a new window will be created and bound
  1046. to this channel.
  1047.  
  1048. EXAMPLES:
  1049.  
  1050. /JOIN #Amigager
  1051.      Join channel #AmigaGER
  1052.  
  1053. /JOIN #Amigager,#AmIRC
  1054.      Join channels #AmigaGER and #AmIRC
  1055.  
  1056. /JOIN #AmigaGER deutsch
  1057.      Join channel #AmigaGER with keyword deutsch.
  1058.  
  1059. RELATED TOPICS:
  1060.  
  1061. See LEAVE.
  1062.  
  1063. KICK
  1064. ----
  1065.  
  1066. Usage: /KICK <channel> <user> [<comment>]
  1067.  
  1068. Forcibly removes a user from the named channel.  the user sending the
  1069. /KICK command must be a channel operator of the named channel.  If the
  1070. optional <comment> is given, it will be shown as the reason for the
  1071. kick.
  1072.  
  1073. EXAMPLES:
  1074.  
  1075. /KICK #AmIRC Freddie Take it outside!
  1076.      forces 'Freddie' from channel #AmIRC with the reason 'take it
  1077.      outside'.
  1078.  
  1079. LASTLOG
  1080. -------
  1081.  
  1082. Usage /LASTLOG <text> searches back through AmIRC's buffer and
  1083. displays all occurances of the specified text.
  1084.  
  1085. EXAMPLES:
  1086.  
  1087. /LASTLOG amirc
  1088.      searches and displays all lines from the buffer containing the
  1089.      text "amirc"
  1090.  
  1091. LEAVE
  1092. -----
  1093.  
  1094. Usage: /LEAVE [channel[,channel[,...]]
  1095.  
  1096. Leaves a channel. If you don't give a channel name as a parameter, the
  1097. channel currently bound to the window in which in the command is
  1098. entered will be left.
  1099.  
  1100. EXAMPLES:
  1101.  
  1102. /LEAVE
  1103.      Leave the channel currently bound to this window.
  1104.  
  1105. /LEAVE #AmigaGER
  1106.      Leave channel #AmigaGER.
  1107.  
  1108. RELATED TOPICS:
  1109.  
  1110. See JOIN.
  1111.  
  1112. LIST
  1113. ----
  1114.  
  1115. Usage: /LIST [<channel>{,<channel>} [<server>]]
  1116.  
  1117. Generates a list of current channels and topics.  If the <channel>
  1118. argument is given, LIST displays that channel's status and topic.
  1119. Private channels show as 'Private' and secret channels are not listed,
  1120. unless the client generating the list is a member of those channels.
  1121.  
  1122. EXAMPLES:
  1123.  
  1124. /LIST
  1125.      Shows a list of all current, non-secret channels.
  1126.  
  1127. /LIST #AmIRC,#amigaGER
  1128.      List channels #AmIRC and #amigaGER
  1129.  
  1130. Logging Options
  1131. ---------------
  1132.  
  1133. Usage: /LOG {[on|off|<Filespec>]}
  1134.  
  1135. /LOG allows you to start/stop logging, as well as setting the log
  1136. filename and displaying status of logging.
  1137.  
  1138. EXAMPLES:
  1139.  
  1140. /LOG
  1141.      Displays current status of logging
  1142.  
  1143. /LOG on
  1144.      Begins logging to the logfile
  1145.  
  1146. /LOG <filespec>
  1147.      Sets the path and name of the logfile.
  1148.  
  1149. Channel MODE
  1150. ------------
  1151.  
  1152. /MODE allows both users and channels to have their modes changed.
  1153.  
  1154. Usage: /MODE <channel> {[+|-]|o|p|s|i|t|n|b|v} [<limit>] [<user>] [<ban
  1155. mask>]
  1156.  
  1157. Used by Channel Operators to change the modes of 'their' channel.  the
  1158. modes available are:
  1159.  
  1160.      o - give/take channel operator privileges;
  1161.      p - private channel flag;
  1162.      s - secret channel flag;
  1163.      i - invite-only channel flag;
  1164.      t - topic settable by channel operator only flag;
  1165.      n - no messages to channel from clients on the outside;
  1166.      m - moderated channel;
  1167.      l - set the user limit to channel;
  1168.      b - set a ban mask to keep users out;
  1169.      v - give/take the ability to speak on a moderated channel;
  1170.      k - set a channel key (password).
  1171.  
  1172. EXAMPLES:
  1173.  
  1174. /MODE #AmIRC +tm
  1175.      Sets topic protection and makes channel moderated for #AmIRC.
  1176.  
  1177. /MODE #AmIRC -o Sarek
  1178.      Removes channel operator status from user 'Sarek' on channel
  1179.      #AmIRC.
  1180.  
  1181. /MODE #AmIRC +l 50
  1182.      Sets limit of 50 users on #AmIRC.
  1183.  
  1184. /MODE #AmIRC -l
  1185.      Removes the limit form #AmIRC
  1186.  
  1187. User MODE
  1188. ---------
  1189.  
  1190. Usage: <nickname> {[+|-]|i|w|s|o}
  1191.  
  1192. These affect how a client is seen by others or what extra messages a
  1193. client will receive. User Modes will only take effect if the Nick of
  1194. the client sending the command, and the nick of the <nickname> argument
  1195. are the same.
  1196.  
  1197. Available User Modes:
  1198.      i - marks a users as invisible;
  1199.      s - marks a user for receipt of server notices;
  1200.      w - user receives wallops;
  1201.      o - operator flag.
  1202.  
  1203. Note that the +o user mode will not work, however, -o will.
  1204.  
  1205. EXAMPLES:
  1206.  
  1207. /MODE freddie +i
  1208.      makes user 'freddie' invisible in the global user list.
  1209.  
  1210. /MODE freddie -o
  1211.      User 'freddie' removes channel operator status from himself.
  1212.  
  1213. MSG (PRIVMSG)
  1214. -------------
  1215.  
  1216. Usage: /MSG <receiver>{,<receiver>} <text to be sent>
  1217.  
  1218. Sends a Private Message to one or more users. Note that this is
  1219. different from a DCC, in that a /MSG (PRIVMSG) is sent thru the IRC
  1220. server to the recipient.  Note that the TAB key will cycle back and
  1221. forth through the users who have /msg'ed you.  This will appear in the
  1222. input string gadget, and you may simply add your message after it.
  1223.  
  1224. EXAMPLES:
  1225.  
  1226. /MSG Kenneth Heya Dude! How's Florida?
  1227.      Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'.
  1228.  
  1229. /MSG Kenneth,Aerosoul I am in Pittsburgh
  1230.      Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul.
  1231.  
  1232. Names
  1233. -----
  1234.  
  1235. Usage /NAMES [<channel>{,<channel>}]
  1236.  
  1237. Gives a list of nicknames on any channel visible to the user(not secret
  1238. or private, or one actually joined by the user performing the command).
  1239.  
  1240. EXAMPLES:
  1241.  
  1242. /NAMES #AmIRC,#amigaGER
  1243.      Will list all users on channels #AmIRC and #amigaGER, provided the
  1244.      channels are visible to the user.
  1245.  
  1246. /NAMES
  1247.      Will return a list of all visible channels and users (Strongly
  1248.      Discouraged!)
  1249.  
  1250. NICK
  1251. ----
  1252.  
  1253. Usage: /NICK <nickname>
  1254.  
  1255. NICK is used to to give yourself or change your current nickname.  If
  1256. the chosen nick is already in use, you wil be notified of this and
  1257. prompted for a new nick.
  1258.  
  1259. EXAMPLES:
  1260.  
  1261. /NICK Phalanx
  1262.      Makes/changes your nickname to 'Phalanx'
  1263.  
  1264. NOTICE
  1265. ------
  1266.  
  1267. Usage: /NOTICE <nickname> <text>
  1268.  
  1269. Smiilar to /MSG, /NOTICE is usually used by Bots or clients being
  1270. controlled by scripts.  /NOTICE messages must never be responded to by
  1271. an automatic reply.  See MSG for syntax examples.
  1272.  
  1273. QUIT
  1274. ----
  1275.  
  1276. Usage: [<Quit message>]
  1277.  
  1278. Used to End an IRC session.  The optional <quit message> is the text
  1279. that will be displayed upon quitting.
  1280.  
  1281. EXAMPLES:
  1282.  
  1283. /QUIT :Gone to have lunch
  1284. RAW
  1285. ---
  1286.  
  1287. Usage: /RAW text
  1288.  
  1289. Sends text directly to the IRC server without any further processing.
  1290. Warning: Don't even think about using this command without interior
  1291. knowledge of the IRC protocol, or you might run into severe trouble.
  1292. See `RFC 1459' for a description of the IRC protocol.
  1293.  
  1294. EXAMPLES:
  1295.  
  1296. /RAW JOIN #IRC-Heros
  1297.      Send the string JOIN #IRC-Heros directly to the IRC server.
  1298.  
  1299. RELATED TOPICS:
  1300.  
  1301. `RFC 1459'.
  1302.  
  1303. TIME
  1304. ----
  1305.  
  1306. Usage: /TIME [<server>]
  1307.  
  1308. Returns the time of day from the server.  If the optional <server>
  1309. argument is given, then that servers local time will be returned.
  1310.  
  1311. EXAMPLES:
  1312.  
  1313. /TIME irc.pitt.edu
  1314.      Returns the local time from server 'irc.pitt.edu'
  1315.  
  1316. TOPIC
  1317. -----
  1318.  
  1319. Usage: /TOPIC <channel> [<topic>]
  1320.  
  1321. The topic command alone will display the channels topic. if the optional
  1322. <topic> argument is given, the topic will be changed to the argument
  1323. given, provided that the topic is not protected, or the user issuing
  1324. the command is an operator on the channel. See MODE.
  1325.  
  1326. EXAMPLES:
  1327.  
  1328. /TOPIC #AmIRC
  1329.      Will display the current topic on #AmIRC.
  1330.  
  1331. /TOPIC #AmIRC Amigas Rule!
  1332.      Will replace the current topic of #AmIRC with the topic 'Amigas
  1333.      Rule'
  1334.  
  1335. USERS
  1336. -----
  1337.  
  1338. Usage: /USERS [<server>]
  1339.  
  1340. Returns a list of users on the server, or, optionally, on the specified
  1341. server.  /USERS may be disabled on most servers for security reasons.
  1342.  
  1343. EXAMPLES:
  1344.  
  1345. /USERS
  1346.      Returns a list of users on the current server
  1347.  
  1348. /USERS irc.colorado.edu
  1349.      Returns a list of users on server 'irc.colorado.edu'.
  1350.  
  1351. USERHOST
  1352. --------
  1353.  
  1354. Usage: /USERHOST <nickname>{<space><nickname>}
  1355.  
  1356. Returns the login@domain for the specified nickname.  Up to five
  1357. nicknames may be specified, each separated by a <space>.
  1358.  
  1359. EXAMPLES:
  1360.  
  1361. /USERHOST DuRaN
  1362.      returns: 'DuRaN is DuRaN@calci.amiganet.pgh.net
  1363.  
  1364. VERSION
  1365. -------
  1366.  
  1367. Usage /VERSION [<server>]
  1368.  
  1369. Returns the version of the server's software.  If the optional <server>
  1370. arguement is given, returns the version of the specified server's
  1371. software.
  1372.  
  1373. EXAMPLES:
  1374.  
  1375. /VERSION *.edu
  1376.      Returns server version information for all servers matching
  1377.      '*.edu'.
  1378.  
  1379. WHO
  1380. ---
  1381.  
  1382. Usage: /WHO [<name> [<o>]]
  1383.  
  1384. Returns a generated list of all users matching the criteria passed to
  1385. the command, i/e. everyone at a particular site, or on a particular
  1386. server.  If the optional <o> argument is specified, /WHO will only
  1387. return information on users that are channel operators.
  1388.  
  1389. EXAMPLES:
  1390.  
  1391. /WHO *.cmu.edu
  1392.      Will list all users at the cmu.edu domain.
  1393.  
  1394. /WHO irc.pitt.edu o
  1395.      will list all operators on irc.pitt.edu server
  1396.  
  1397. WHOIS
  1398. -----
  1399.  
  1400. Usage: /WHOIS [<server>] <nickmask>[,<nickmask>[,...]]
  1401.  
  1402. Returns information about the specified user or users, that you are
  1403. allowed to see.  If the optional <server> argument is specified, then
  1404. information aobut the user in relation to that specified server will be
  1405. given, i/e idle time.
  1406.  
  1407. EXAMPLES:
  1408.  
  1409. /WHOIS Phalanx
  1410.      Returns available information about user 'Phalanx'.
  1411.  
  1412. /WHOIS irc.bu.edu Phalanx
  1413.      Asks server 'irc.bu.edu' for information on user 'Phalanx
  1414.  
  1415. WHOWAS
  1416. ------
  1417.  
  1418. Usage /WHOWAS <nickname> [<count> [<server>]]
  1419.  
  1420. returns information on a nick that no longer exists, due to the user
  1421. leaving the server or changing their nick. The optional <count> argument
  1422. specifies how many previous instances of the nick should be returned.
  1423. The optional <server> argument specifies a particular server to be
  1424. searched.
  1425.  
  1426. EXAMPLES:
  1427.  
  1428. /WHOWAS Aerosoul 5
  1429.      Checks for and returns available information on the last 5
  1430.      instances of the nick 'Aerosoul'.
  1431.  
  1432. Customizing your environment
  1433. ****************************
  1434.  
  1435. Overview
  1436. ========
  1437.  
  1438. Now that you have AmIRC running, you may want to get it to operate the
  1439. way you want it to, and to look pleasing as well.  This is achieved
  1440. thru both MUI preferences and AmIRC's Menu options.
  1441.  
  1442. Changing MUI Settings
  1443. *********************
  1444.  
  1445. MUI Preferences
  1446. ===============
  1447.  
  1448. Most of the configuration dealing with how AmIRC's GUI appears can be
  1449. customized with About MUI.  Check the 'MUI Settings...' entry under the
  1450. 'Settings' menu.  This will pop up MUI's interface, allowing you to
  1451. setup AmIRC's MUI Prefs, without disturbing any of your other MUI
  1452. configurations. Read the documentation for MUI to Learn more about the
  1453. operation of MUI Preferences.
  1454.  
  1455. Changing AmIRC Options
  1456. **********************
  1457.  
  1458. AmIRC Setup
  1459. ===========
  1460.  
  1461. Most of the setup functions appear in the 'Setup' entry under the
  1462. 'Settings' & 'Lists' menus. Here you will get a multi-requestor that
  1463. will allow you to access several pages that deal with configuring AmIRC.
  1464.  
  1465. Messages Page
  1466. *************
  1467.  
  1468. Misc Messages
  1469. =============
  1470.  
  1471. CTCP Userinfo
  1472.      The text in this string is what will be returned to a user who
  1473.      sends '/CTCP userinfo' to your client.
  1474.  
  1475. KICK Reason
  1476.      If you are a channel operator and /kick another user from the
  1477.      Channel, this test will appear as the reason for the /KICK.
  1478.  
  1479. Quit Messages
  1480. =============
  1481.  
  1482. Exit
  1483.      This will appear to users in the channel when you exit AmIRC.
  1484.  
  1485. New Server
  1486.      This text will appear to users in the channel when you select
  1487.      'Select Server' in the 'AmIRC' menu, and pick a new server to
  1488.      connect to.
  1489.  
  1490. System Reset
  1491.      This is the text to appear if you reboot your amiga (Crtl-
  1492.      amiga-amiga) while connected to a server.
  1493.  
  1494. AWAY Messages
  1495. =============
  1496.  
  1497. Default
  1498.      This is the text that will appear when you are set 'away' by
  1499.      selecting the 'Marked Away?' item in the 'User Modes' menu.
  1500.  
  1501. AutoAWAY
  1502.      text that appears when you are automatically set away due to
  1503.      inactivity.
  1504.  
  1505. Timeout
  1506.      This sets how much time will pass before AmIRC assumes you are
  1507.      away from the computer and marks you as 'AWAY'.  If set to 0
  1508.      (Zero), timeout will be disabled.
  1509.  
  1510. UnAWAY
  1511.      This cycle gadget allows you to choose the conditions of which
  1512.      AmIRC will automatically set you to 'Not AWAY'.
  1513.  
  1514. Actions Page
  1515. ************
  1516.  
  1517. Actions
  1518. =======
  1519.  
  1520. The 24 text gadgets in the 'Label:' column here correspond to the
  1521. gadgets under the user list on AmIRC's main window.  You may set these
  1522. gadgets to be anything, sort of like macros.  AmIRC, however, does
  1523. include configurable function keys to act as macros, so these gadgets
  1524. are preset for /ctcp, /dcc, and /mode operations.
  1525.  
  1526. Below the text gadgets is a quick reference of the placeholders that
  1527. can be used in the desired operation.  These actions can also be
  1528. accessed by clicking the right mouse button in the title bar of the
  1529. AmIRC screen after clicking on a users nick with the left mouse button.
  1530.  
  1531. Events Page
  1532. ***********
  1533.  
  1534. Events
  1535. ======
  1536.  
  1537. Here you may define certain actions to take place upon incoming events.
  1538. These actions can be as simple as a warning beep from your amiga, or a
  1539. complex and powerful rexx command.  The following text first explains
  1540. the functions of the columns of this page, and then goes on to explain
  1541. what each event is.
  1542.  
  1543. Columns
  1544. -------
  1545.  
  1546. Event
  1547.      The particular event for the action to take place on.
  1548.  
  1549. Deiconify
  1550.      If AmIRC is iconified, this will uniconify and bring to front the
  1551.      AmIRC window on the occurence of the event.
  1552.  
  1553. Beep
  1554.      This will perform a system beep on the occurence of the event
  1555.  
  1556. Sound
  1557.      if a sound sample is preferred for the event, you may use the
  1558.      requestor gadget to pick a sound to play instead of the system
  1559.      beep.  Please Note, AmIRC uses the DataTypes of OS 3.x for sounds,
  1560.      and you will not be able to use this feature under OS 2.x.
  1561.  
  1562. Vol
  1563.      This sets the volume for the sound sample.  The valid range for
  1564.      the volume is 0 - 64.  This is a slider gadget.  The small gadget
  1565.      just to the left of this silder gadget can be used to test the
  1566.      selected soundfile.
  1567.  
  1568. Rexx Command
  1569.      Here you may configure a rexx script to be run on the occurence of
  1570.      the event.
  1571.  
  1572. Events
  1573. ------
  1574.  
  1575. Any Message
  1576.      This Event occurs on any incoming public message.
  1577.  
  1578. Private Msg
  1579.      This event occurs when you receive an incoming private /msg or /dcc
  1580.      chat message
  1581.  
  1582. Notice
  1583.      This event occurs when an operator sends out a /notice
  1584.  
  1585. CTCP request
  1586.      This event occures when your client receives any /ctcp request (for
  1587.      example /ctcp time, or /ctcp version
  1588.  
  1589. DCC request
  1590.      This event occurs on receiving a /dcc file transfer request or chat
  1591.      request.
  1592.  
  1593. Join
  1594.      This event occurs when anyone /joins the channel you are currently
  1595.      on.
  1596.  
  1597. Kick
  1598.      This event occurs when anyone is /Kicked from the channel you are
  1599.      currently on.
  1600.  
  1601. Mode change
  1602.      This event occurs when the channel mode is changed for the channel
  1603.      you are currently on, i/e. if someone is /OPed or /DeOPed, or if
  1604.      the channel is made private, etc.
  1605.  
  1606. ISON Notify
  1607.      This event occurs when AmIRC 'sees' a user that is configured in
  1608.      your 'Notify' list.
  1609.  
  1610. Connection
  1611.      This event occurs when AmIRC makes a connection to an IRC server.
  1612.  
  1613. Invite
  1614.      This event occurs when another user invites you to join a channel
  1615.      that is currently set to /MODE 'Invite Only'
  1616.  
  1617. Highlight
  1618.      This even occurs upon receiving text that is configured in the
  1619.      highlights secton of the lists setup.
  1620.  
  1621. GUI Configuration
  1622. *****************
  1623.  
  1624. GUI
  1625. ===
  1626.  
  1627. The GUI configuraton page allows you to control some specific aspects
  1628. of AmIRC that arent covered in the MUI configuration.
  1629.  
  1630. Userlist:
  1631. ---------
  1632.  
  1633. The userlist cycle gadget allows you to control if the User List is
  1634. visible or not visible, and if it is visible, if it is a separate
  1635. window, or a part of the AmIRC window.  If the Sort Gadget is check
  1636. marked, the list will be sorted alphabetically, otherwise, the list
  1637. will reflect the order that the users have joined the chat.
  1638.  
  1639. The Order cycle gadget allows you to choose how the nicks in the
  1640. userlist will be listed, Alphabetically, new at top, or new at bottom.
  1641.  
  1642. The Buttons? Gadget will toggle on & off the gadgets in the User
  1643. Action List, located below the user list.  If the user list is
  1644. configured as a separate window, the buttons will also appear in that
  1645. window.
  1646.  
  1647. The Userlist win open? gadget will control if the userlist is open or
  1648. closed if configured as a separate window.
  1649.  
  1650. Misc
  1651. ----
  1652.  
  1653. Here you may select a different pubscreen for the query window to appear
  1654. on.  If no pubscreen is specified, the Query window will open on the
  1655. AmIRC default screen.
  1656.  
  1657. Text Colors
  1658. -----------
  1659.  
  1660. In this section, you may configure the colors that certain text will
  1661. appear in AmIRC.  These colors are based on the MUI pen colors that you
  1662. have configured in MUI.  Just click and hold on the cycle gadget to see
  1663. a list of the MUI Pen colors available.
  1664.  
  1665. Normal Text
  1666.      Text that is a normal message from a user.
  1667.  
  1668. Private Messages
  1669.      Text that is a private message from another user to you.
  1670.  
  1671. Mode Changes
  1672.      Text that shows a mode change for the channel.
  1673.  
  1674. Highlighted Text
  1675.      text that is configured in the Lists list for AmIRC.
  1676.  
  1677. Server Messages
  1678.      Text that comes from the server, i/e when a user joins or exits the
  1679.      channel.
  1680.  
  1681. CTCP/DCC Messages
  1682.      Text that informs you of an incoming CTCP or DCC request.
  1683.  
  1684. Logging
  1685. -------
  1686.  
  1687. Here you may enter the path & name to use for the logfile.
  1688.  
  1689. Misc Configuration
  1690. ******************
  1691.  
  1692. Miscellaneous Configuration Items
  1693. =================================
  1694.  
  1695. CTCP COUND handling
  1696. -------------------
  1697.  
  1698. Here you may set the directory where AmIRC looks for files requested by
  1699. incoming /CTCP Sound requests. Also, the volume of the sound to be
  1700. played back can be set.
  1701. If the "Use external player?" gadget is checked, AmIRC will attempt to
  1702. use the player specified in the "player command line" gadget to play
  1703. sounds.  This player applies to ctcp sound requests as well as sounds
  1704. configured in the setup/events tab.
  1705.  
  1706. "Lists..." Menu Item
  1707. ********************
  1708.  
  1709. Lists Configuration
  1710. ===================
  1711.  
  1712. Alias Tab
  1713. ---------
  1714.  
  1715. Here you can create aliases, or shortcuts for complex IRC commands.
  1716. Some examples have been created for you, and a reference template
  1717. appears at the bottom of this page. %p is the place holder for any
  1718. arguments you may wish to add when using an alias.
  1719.  
  1720. Ignore Tab
  1721. ----------
  1722.  
  1723. Here you can set which users if any you want to ignore, and what kind of
  1724. messages from them to ignore.  To add an ignore to the list, click the
  1725. 'Add Ignore' gadget, then type the user's name in the text input gadget
  1726. labeled 'Ignore'.  Next click on the type of messages you want to
  1727. ignore. Checking the 'text' box will prevent you from seeing any public
  1728. messages from the user.  Setting the 'privmsgs' box will prevent you
  1729. from seeing /MSGs from that user to you.  Likewise, clicking the
  1730. 'CTCPs' box will prevent you from seeing any CTCP requests from the
  1731. Ignored user.  To delete an ignore, click on the entry you wish to
  1732. delete, and then click on the 'delete ignore' gadget.
  1733.  
  1734. Hilite Tab
  1735. ----------
  1736.  
  1737. Here you may set certain text to be highlighted in order to get your
  1738. attention if that text appears.  You may set text to match the nick,
  1739. Userhost, or any keyword enclosed in double quotes. To add a new
  1740. pattern, click on the Button labeled "Add new Hilite pattern", and type
  1741. your pattern into the input gadget.  To delete an existing pattern,
  1742. Click on the entry yo uwish to delete and then click on the button
  1743. labeled "Delete Hilite pattern".  The Hilite patterns will ignore a
  1744. pattern it recognizes if it was input by you, but will activate on the
  1745. pattern from other users.
  1746.  
  1747. Pattern Definitions:
  1748. --------------------
  1749.  
  1750. Nick
  1751.      This will watch the AmIRC listview for the nick that you specify,
  1752.      and highlight the text for that users message.  The 'Nick' entry
  1753.      does not require double quotes.
  1754.  
  1755. Userhost
  1756.      This will watch for messages that originate from a particular
  1757.      Userhost, and highlight the text for that message. Userhost
  1758.      entries may contain wildcards.  Examples:
  1759.  
  1760.     fred!fdoe@doe1.powernet.edu
  1761.           This will highlight only messages from fred at that
  1762.           particular address.
  1763.  
  1764.     fred!*@*
  1765.           This will highlight messages from anyone named fred,
  1766.           regardless of address or login name.
  1767.  
  1768.     Fred!*@*.powernet.edu
  1769.           This will highlight messages from anyone named fred on any
  1770.           machine on powernet.edu
  1771.  
  1772.     *!*@doe1.powernet.edu
  1773.           This will highlight any messages from anyone on the doe1
  1774.           machine at powernet.edu
  1775.  
  1776.     *!*@*
  1777.           This will highlight any messages from any user.
  1778.  
  1779. "Keyword"
  1780.      This will highlight any message that contains the text enclosed in
  1781.      double quotes.
  1782.  
  1783. Function Key Definitions
  1784. ************************
  1785.  
  1786. Function Keys
  1787. =============
  1788.  
  1789. Here you may define the Amiga's ten functon keys to insert text into
  1790. the input string gadget of AmIRC. By using the keys normally, or with
  1791. the 'shift' or 'crtl' modifiers, you may define up to 30 text input
  1792. macros that can be used at the press of a key. This is similar to the
  1793. functon key macros found on many popular terminal emulation programs.
  1794.  
  1795. A /n at the end of a function key definition will send a <CR> after
  1796. the text.  The function key definitions also allow placeholders,
  1797. similar to the Operation.
  1798.  
  1799. AmIRC's ARexx Port
  1800. ******************
  1801.  
  1802. Overview
  1803. ========
  1804.  
  1805. AmIRC supports a versatile ARexx Port.
  1806.  
  1807. Reference
  1808. =========
  1809.  
  1810. SAY
  1811. ---
  1812.  
  1813. Usage: SAY TEXT/F
  1814.  
  1815. DESCRIPTION:
  1816.  
  1817. Treats TEXT just like it has been entered in the string gadget of the
  1818. current window.
  1819.  
  1820. EXAMPLES:
  1821.  
  1822.     say '/JOIN #Amigager'
  1823.  
  1824. RELATED TOPICS: See RX_ECHO.
  1825.  
  1826. ISCONNECTED
  1827. -----------
  1828.  
  1829. Usage: ISCONNECTED
  1830.  
  1831. DESCRIPTION:
  1832.  
  1833. Checks whether a connection is currently established. Returns RC 0 if
  1834. the link is up, RC 5 otherwise.
  1835.  
  1836. EXAMPLES:
  1837.  
  1838.     ISCONNECTED; say rc
  1839.  
  1840. RELATED TOPICS:
  1841.  
  1842. GETMYNICK
  1843. ---------
  1844.  
  1845. Usage: GETMYNICK
  1846.  
  1847. DESCRIPTION:
  1848.  
  1849. Returns your current nickname.
  1850.  
  1851. EXAMPLES:
  1852.  
  1853.     GETMYNICK; say result
  1854.  
  1855. RELATED TOPICS: See RX_GETSERVERNAME.
  1856.  
  1857. GETSERVERNAME
  1858. -------------
  1859.  
  1860. Usage: GETSERVERNAME
  1861.  
  1862. DESCRIPTION:
  1863.  
  1864. Returns the name of the IRC server you are currently connected to.
  1865.  
  1866. EXAMPLES:
  1867.  
  1868.     GETSERVERNAME; say result
  1869.  
  1870. RELATED TOPICS: See RX_GETMYNICK.
  1871.  
  1872. USERHOST
  1873. --------
  1874.  
  1875. Usage: USERHOST NICK/A
  1876.  
  1877. DESCRIPTION:
  1878.  
  1879. Returns the userhost specification belonging to NICK.
  1880. AMIRC keeps a internal list of the userhosts of every nick that occured
  1881. yet. You can query this database with this command.  Note however that
  1882. it is possible that the userhost isn't in the database yet; this
  1883. command will not query the server than, but simply return an error.
  1884.  
  1885. EXAMPLES:
  1886.  
  1887.     USERHOST Olli; say result
  1888.  
  1889. RELATED TOPICS: See RX_GETMYNICK.
  1890.  
  1891. ECHO
  1892. ----
  1893.  
  1894. Usage: ECHO P=PREFIX/K, TEXT/F
  1895.  
  1896. DESCRIPTION:
  1897.  
  1898. Sends text to the listview
  1899.  
  1900. EXAMPLES:
  1901.  
  1902.     ECHO P=Kewlja This is echo test
  1903.  
  1904. RAW
  1905. ---
  1906.  
  1907. Usage: RAW TEXT/F
  1908.  
  1909. DESCRIPTION:
  1910.  
  1911. Sends text to the server in raw format.
  1912.  
  1913. EXAMPLES:
  1914.  
  1915.     RAW PRIVMSG phalanx: heya! whats happening?
  1916.  
  1917. CHANNELS
  1918. --------
  1919.  
  1920. Usage: CHANNELS NULL
  1921.  
  1922. DESCRIPTION:
  1923.  
  1924. Returns a list of channels currently joined in the format: "#channel1
  1925. #channel2 etc."
  1926.  
  1927. EXAMPLES:
  1928.  
  1929.     options results; channels; say result
  1930.  
  1931. GETCHANNEL
  1932. ----------
  1933.  
  1934. Usage: GETCHANNEL
  1935.  
  1936. DESCRIPTION:
  1937.  
  1938. Returns the name of the channel currently active in the format:
  1939. "#channel."
  1940.  
  1941. EXAMPLES:
  1942.  
  1943.     options results; getchannel; say result
  1944.  
  1945. RELATED TOPICS: See RX_CHANNELS.
  1946.  
  1947. GETSELECTEDUSER
  1948. ---------------
  1949.  
  1950. Usage: GETSELECTEDUSER
  1951.  
  1952. DESCRIPTION:
  1953.  
  1954. Returns the Nick the user highlighted in the userlist window.
  1955.  
  1956. EXAMPLES:
  1957.  
  1958.     options results; getselecteduser; say result
  1959.  
  1960. RELATED TOPICS: See RX_GETUSER, See RX_GETUSERS.
  1961.  
  1962. GETUSER
  1963. -------
  1964.  
  1965. Usage GETUSER /N
  1966.  
  1967. DESCRIPTION:
  1968.  
  1969. Returns the nick of the user number given on the active channel
  1970. userlist.
  1971.  
  1972. EXAMPLES:
  1973.  
  1974.     options results; getuser 1; say result
  1975.  
  1976. RELATED TOPICS: See RX_GETSELECTEDUSER, See RX_GETUSERS.
  1977.  
  1978. GETUSERS
  1979. --------
  1980.  
  1981. Usage GETUSERS
  1982.  
  1983. DESCRIPTION:
  1984.  
  1985. Returns a string containing the list of users on the active channel.
  1986.  
  1987. EXAMPLES:
  1988.  
  1989.     options results; getusers; say result
  1990.  
  1991. RELATED TOPICS: See RX_GETUSER, See RX_GETSELECTEDUSER.
  1992.  
  1993. GETUSERSTATE
  1994. ------------
  1995.  
  1996. Usage GETUSERSTATE /N
  1997.  
  1998. DESCRIPTION:
  1999.  
  2000. Returns the status of user "num" on the active channel.
  2001. RC=0 User is online, but has no special status.
  2002. RC=1 User is Channel Operator.
  2003. RC=2 User is online and has been "Voiced".
  2004. RC=5 User # not in the userlist.
  2005. EXAMPLES:
  2006.  
  2007.     options results; getuserstate 1; say rc
  2008.  
  2009. GETLINE
  2010. -------
  2011.  
  2012. Usage GETLINE
  2013.  
  2014. DESCRIPTION:
  2015.  
  2016. Waits for a line from the server and returns the following stem
  2017. variables;.
  2018. LINE        = The entire, unparsed, line recieved.
  2019. LINE.PREFIX = The Nick and user@host.
  2020. LINE.COMMAND= The MSG Type.
  2021. LINE.DEST   = The channel the message was written to.
  2022. LINE.REST   = The message text.
  2023. EXAMPLES:
  2024.  
  2025.     options results
  2026.  
  2027. getline
  2028.  
  2029. text=line prefix=line.prefix comm=line.command dest=line.dest
  2030. rest=line.rest
  2031.  
  2032. say text,prefix,comm,dest,rest
  2033.  
  2034. RELATED TOPICS: See RX_PARSELINE, See RX_GETLASTLINE.
  2035.  
  2036. GETLINECOUNT
  2037. ------------
  2038.  
  2039. Usage GETLINECOUNT
  2040.  
  2041. DESCRIPTION:
  2042.  
  2043. Returns the number of lines in the channel buffer for the active window
  2044. channel.
  2045.  
  2046. EXAMPLES:
  2047.  
  2048.     options results; getlinecount; say result
  2049.  
  2050. RELATED TOPICS: See RX_GETLINE.
  2051.  
  2052. GETLASTLINE
  2053. -----------
  2054.  
  2055. Usage GETLASTLINE
  2056.  
  2057. DESCRIPTION:
  2058.  
  2059. Returns the last private message received in the format;.
  2060. :nick!~user@host Messagetype Nick :message text.
  2061.  
  2062. EXAMPLES:
  2063.  
  2064.     options results; getlastline; say result
  2065.  
  2066. RELATED TOPICS: See RX_PARSELINE, See RX_GETLINE.
  2067.  
  2068. GETAWAYSTATE
  2069. ------------
  2070.  
  2071. Usage GETAWAYSTATE
  2072.  
  2073. DESCRIPTION:
  2074.  
  2075. Returns your away status.
  2076. rc=0 Not away.
  2077. rc=5 Away.
  2078. EXAMPLES:
  2079.  
  2080.     options results; getawaystate; say rc
  2081.  
  2082. GETVERSION
  2083. ----------
  2084.  
  2085. Usage GETUSERS
  2086.  
  2087. DESCRIPTION:
  2088.  
  2089. Returns the Version number of AmIRC.
  2090.  
  2091. EXAMPLES:
  2092.  
  2093.     options results; getversion; say result
  2094.  
  2095. PARSELINE
  2096. ---------
  2097.  
  2098. Usage PARSELINE
  2099.  
  2100. DESCRIPTION:
  2101.  
  2102. Parses the line specified and returns the following stem variables;
  2103. LINE        = The entire, unparsed, line recieved.
  2104. LINE.PREFIX = The Nick and user@host
  2105. LINE.COMMAND= The MSG Type
  2106. LINE.DEST   = The channel the message was written to.
  2107. LINE.REST   = The message text.
  2108. EXAMPLES:
  2109.  
  2110.     options results
  2111.  
  2112. getlastline last=result parseline last
  2113.  
  2114. text=line prefix=line.prefix comm=line.command dest=line.dest
  2115. rest=line.rest
  2116.  
  2117. say text,prefix,comm,dest,rest
  2118.  
  2119. RELATED TOPICS: See RX_GETLINE, See RX_GETLASTLINE.
  2120.  
  2121. Magic User Interface
  2122. ********************
  2123.  
  2124. About MUI
  2125. =========
  2126.  
  2127.  
  2128.                                This application uses
  2129.      
  2130.      
  2131.                              MUI - MagicUserInterface
  2132.      
  2133.                      (c) Copyright 1993/94 by Stefan Stuntz
  2134.      
  2135.      
  2136.                         Without MUI, AmIRC wouldn't exist.
  2137.      
  2138.      
  2139.                If you want to register directly, feel free to send
  2140.      
  2141.      
  2142.                               DM 30.-  or  US$ 20.-
  2143.      
  2144.                                        to
  2145.      
  2146.                                   Stefan Stuntz
  2147.                              Eduard-Spranger-Straße 7
  2148.                                   80935 München
  2149.                                      GERMANY
  2150.  
  2151. Why MUI?
  2152. ========
  2153.  
  2154. Why MUI? you ask...
  2155. MUI is the most powerful application framework toolkit available for any
  2156. platform.  MUI allows applications to provide their users with a highly
  2157. usable, fast and configurable user interface which works well on any
  2158. screen setting, from a 640x200 NTSC display to a 1280x1024 true color
  2159. graphics board.  MUI applications use less memory than comparable
  2160. applications since they can rely on a huge set of shared class code,
  2161. which is especially true if several MUI apps are run on the same
  2162. machine.
  2163.  
  2164. Plus, MUI's powerful OO class methods allows the application programmer
  2165. to work on the program's functionality instead of doing repetitive low
  2166. level tasks, resulting in much more powerful applications given the same
  2167. development times.  MUI's GUI classes overcome the severe design bugs in
  2168. the ROM internal BOOPSI gadget classes, allowing for complex GUI objects
  2169. without high priority CPU hogging or potential system deadlocks.
  2170.  
  2171. MUI compacts over 4 years of development and optimization in a powerful
  2172. toolkit, an effort no application programmer can afford to invest in his
  2173. own development.
  2174.  
  2175. Those Deserving Favour
  2176. **********************
  2177.  
  2178. Thanks to::
  2179. ===========
  2180.  
  2181. The author wishes to thank the following people for their help during
  2182. AmIRC development:
  2183.  
  2184. Karl 'Phalanx' Bellve
  2185.      Who provided space, connectivity and cpu time for running the
  2186.      AmIRC support area.  He also helped during development, and did
  2187.      alot of encouragement. :-)
  2188.  
  2189. Laurence 'DuRaN' Walton
  2190.      Who did write the documentation, first installer and also helped
  2191.      alot during development in other respects.
  2192.  
  2193. Christopher 'ChrisDi' Dietz
  2194.      Who did the German catalog translation.
  2195.  
  2196. Philippe 'PhB' Brand
  2197.      Who did the french catalog translation.
  2198.  
  2199. Fredrik Rambris
  2200.      Who did the swedish catalog translation.
  2201.  
  2202. Pascal 'arcade' Eeftinck
  2203.      Who did the dutch catalog translation.
  2204.  
  2205. Juan 'Goliath' Ramirez
  2206.      Who did the Spanish translation
  2207.  
  2208. Manuel 'CCCP' Giorgini
  2209.      Who did the Italian translation
  2210.  
  2211. Troy 'Doogie' Davis
  2212.      Who helped much with testing and developing the ARexx port, besides
  2213.      reporting bugs and making useful suggestions of other kinds.
  2214.  
  2215. Robert 'RobR' Reiswig
  2216.      Who did write the installer script.
  2217.  
  2218. Mike 'Mike' Fitzgerald
  2219.      for writing the ARexx Section of the docs
  2220.  
  2221. Olaf 'Olsen' Barthel
  2222. Michael 'mlelstv' van Elst
  2223. Kenneth 'Kenneth' Jennings
  2224. David 'Deathland' Zvekic
  2225.      for their help with debugging the as225r2 code.
  2226.  
  2227. Klaus 'kmel' Melchior
  2228.      for his help with tracking down several MLink problems.
  2229.  
  2230. Andreas M. 'bonzo' Kirchwitz
  2231.      for useful advice and showing a good load of humor during the
  2232.      //KICKBAN test.
  2233.  
  2234. Ralph 'rbabel' Babel
  2235.      who helped to track down a nasty bug in slink's constructor
  2236.      priority ordering.
  2237.  
  2238. The SAS/C Amiga Development team
  2239. (Especially Steve Krueger)
  2240.      For their continued support of the SAS/C Compiler
  2241.  
  2242. Holger 'hkr' Kruse
  2243.      who pointed out the easy solution to the WTF is my own IP
  2244.      number? problem
  2245.  
  2246. Jason 'morden' Murray
  2247. Robert 'Devo' Bradman
  2248.      who drew the OP and VOICE icons
  2249.  
  2250. Angela 'Nessy' Schmidt
  2251. Christoph 'Pepo' Feck
  2252. Sascha 'Master' Lentz
  2253.      who helped test several AmIRC features in a real-life environment
  2254.      (say #AmigaGER ;-)
  2255.  
  2256. The IRC admin at irc.uni-paderborn.de
  2257. (Thomas 'Heager' Thissen)
  2258.      which served as the primary test site
  2259.  
  2260. Brian 'SmknDHerb' Maurino
  2261. Sandro 'Sandro' Catallo
  2262. Robert 'Gostrider' Wilkins
  2263.      Who created and compiled the demo sounds
  2264.  
  2265. Fionn 'Fionn' Behrens
  2266. Frank 'Daddie' Peters
  2267. Holger 'Heureka' Jakob
  2268. Jens 'Jens' Hünerberg
  2269. Mathias 'Merlin' Mischler
  2270. Michael 'mickh' Hohmann
  2271. Nicole 'Talyn' Brandt
  2272. Peter 'Stoebi' Schulz
  2273. Roy 'AK' Millican
  2274. Thomas 'logo' Butter
  2275.      for early testing and design suggestions
  2276.  
  2277. Christoph 'CeeGee' Gülicher
  2278. Danny 'Danny' Amor
  2279. Markus 'Ill' Illenseer
  2280. Markus 'Lammy' Lamers
  2281. Matthias 'DrMabuse' Lühr
  2282.      who simply bugged me to get on the list :)
  2283.  
  2284. Osma 'Tau' Ahvenlampi
  2285.      The major inspiration for the IGNORE support in AmIRC
  2286.  
  2287. This Document Prepared by Laurence Walton
  2288.  
  2289. ©1995 Oliver Wagner
  2290. All Rights Reserved
  2291.  
  2292. How to Report Bugs
  2293. ******************
  2294.  
  2295. Bug Reports
  2296. ===========
  2297.  
  2298.  
  2299.      Please send bug reports to AmIRC@vapor.com, not to my
  2300.      standard mailbox.  Include in the report the OS version of your
  2301.      amiga, The version of MUI that you have installed, and the version
  2302.      of AmIRC that you are using.
  2303.      
  2304.      Problems or additions of the AmIRC documentation should be directed to:
  2305.      
  2306.      lww@vapor.com
  2307.  
  2308. Problems, Causes, & Cures
  2309. *************************
  2310.  
  2311. Known Bugs
  2312. ==========
  2313.  
  2314.    * You absolutely MUST install SetPatch 40.16 (or higher), otherwise
  2315.      you will stumble over the broken pool functions in 3.0/3.1 exec
  2316.  
  2317.    * The main window sometimes doesn't refresh properly when
  2318.      SIMPLE_REFRESH is used.  Known bug in MUI 2.3's listview refresh
  2319.      sometimes throwing away damage regions.  Fixed in MUI 3.
  2320.  
  2321.    * System deadlock when having an ObtainGIRPort hack installed.  This
  2322.      hacks break a few of the ROM internal BOOPSI gadget classes
  2323.      (notable the propgclass which is used by AmIRC for it's scroller)
  2324.      and MUST not be used. Older versions suggested to install such a
  2325.      hack to avoid MagicMenu lockups; this was before the system
  2326.      hostility of the ObtainGIRPort hack was unveiled.
  2327.  
  2328.    * There are various problems when using AmIRC as a CLChat (ArcNet)
  2329.      client.  These are all caused by bugs within CLChatIRCD and can't
  2330.      be fixed on AmIRC's side.
  2331.  
  2332.    * ALT-CURSOR-UP/DOWN doesn't work with MultiCX. MultiCX's "advanced
  2333.      Edithook" will eat Cursor-UP/Down-Inputevent on it's own so they
  2334.      can't be processed by AmIRC. Use a different edit hook.
  2335.  
  2336.    * ZFREQ causes AmIRC to fail upon start. ZFREQ seems to be unable to
  2337.      bear an application allocating a real huge number of
  2338.      ASL_Filerequest structures. Use a different file requester patch.
  2339.  
  2340.    * Neither HILITE nor URL-Grabber work on text written by yourself.
  2341.      This is due to internal reasons, I'm not sure if it is worth
  2342.      changing.
  2343.  
  2344. How to Get Help & Updates
  2345. *************************
  2346.  
  2347. Support
  2348. =======
  2349.  
  2350.     AmIRC Support Mailing List
  2351.  
  2352.      To keep up to date on AmIRC improvements or to get answers to AmIRC
  2353.      problems, Join the AmIRC support mailing list by sending email to:
  2354.      
  2355.      <AmIRC-Request@vapor.com>
  2356.      
  2357.      with the text "ADD" in the body.
  2358.      
  2359.      AmIRC FTP Support Site
  2360.      
  2361.      For AmIRC Updates & Patches, ftp to:
  2362.      
  2363.      ftp.vapor.com, /pub/amirc/
  2364.      
  2365.      AmIRC Support on the World Wide Web
  2366.      
  2367.      Or, Alternatively, Visit the AmIRC WWW Support Site at:
  2368.      
  2369.      http://www.vapor.com/amirc/
  2370.  
  2371. Index
  2372. *****
  2373.  
  2374.  
  2375.  
  2376.  Actions Options                        Actions
  2377.  Aliases, setting up                    Lists
  2378.  AmIRC Menu                             AmIRC
  2379.  AmIRC Support                          AmIRC Support
  2380.  ARexx Menu                             Rexx
  2381.  ARexx Reference                        ARexx
  2382.  Away, Setting                          AWAY
  2383.  Buffer searching                       LASTLOG
  2384.  Bugs, Known                            Known Bugs
  2385.  Bugs, Reporting                        Bug Reports
  2386.  Channel Modes, changing                MODE
  2387.  Commands                               Commands
  2388.  Configuration Options                  AmIRC Setup
  2389.  Configuration with MUI                 MUI Preferences
  2390.  Configuring AmIRC                      Configuration
  2391.  Connecting to an IRC server            Connecting
  2392.  Contents, Table of                     Top
  2393.  Copyright Information                  Copyright
  2394.  Credits                                Credits
  2395.  CTCP                                   CTCP
  2396.  CTCP Sound Settings                    Misc
  2397.  DCC                                    DCC
  2398.  Events Options                         Events
  2399.  Features Of AmIRC                      Features
  2400.  Function Keys, Setting up              Function Keys
  2401.  GUI Options                            GUI
  2402.  Hilighting certain text                Lists
  2403.  Igoring Users                          Lists
  2404.  Installing AmIRC                       Installation
  2405.  Inviting a user to a channel           INVITE
  2406.  IRC                                    IRC
  2407.  IRC Terminology                        IRC Terms
  2408.  Joining a channel                      JOIN
  2409.  Kicking a user from a channel          KICK
  2410.  Known Bugs                             Known Bugs
  2411.  Leaving a channel                      LEAVE
  2412.  LIsting Channels                       LIST
  2413.  Listing names on IRC                   NAMES
  2414.  Listing Users on a server              USERS
  2415.  Lists Menu                             Lists
  2416.  Logging Channel Text                   LOG
  2417.  Menus                                  Menus
  2418.  Messages options                       Messages
  2419.  MUI Configuration                      MUI Preferences
  2420.  MUI, About                             About MUI
  2421.  Net Etiquette                          IRC
  2422.  Nickname, Changing                     NICK
  2423.  Nickname, Setting                      NICK
  2424.  Notice, Sending                        NOTICE
  2425.  Operating AmIRC                        Operation
  2426.  Pattern matching of users              WHO
  2427.  Private message, sending               MSG
  2428.  Quitting IRC                           QUIT
  2429.  Raw text, sending                      RAW
  2430.  Registering AmIRC                      Registration
  2431.  Reporting Bugs                         Bug Reports
  2432.  Requirements for running AmIRC         Requirements
  2433.  Settings Menu                          Settings
  2434.  Settings menu: Actions                 Actions
  2435.  Settings Menu: Events                  Events
  2436.  Settings Menu: GUI                     GUI
  2437.  Settings Menu: Messages                Messages
  2438.  Support for AmIRC users                AmIRC Support
  2439.  Thanks to...                           Credits
  2440.  Time, getting server's                 TIME
  2441.  Topic, Changing the                    TOPIC
  2442.  User Modes Menu                        User Modes
  2443.  User's, finding more info on           WHOIS
  2444.  User, checking if on                   ISON
  2445.  Userhost, finding a user's             USERHOST
  2446.  Version, server's software             VERSION
  2447.  What is IRC                            IRC
  2448.  Who Was User                           WHOWAS
  2449.  Windows Menu                           Windows
  2450.  
  2451.